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ABSTRACT: Super STEP Is a machine language program designed t 
be used in conjunction with TBUG tm (No. 26-2001), the TRS-80 m 
Z30 monitor program aold by Radio Shack/Tandy Corp. Super STEP 
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CPU registers, stack elements 



ister configuration. Also displayed is an intelligent RAM vindov 
that selectively posts local RAM environments or a user-designated 
area. One or both of the 280 Models can be suppressed, as can the 
scrolling field, for full screen access. The variable speed TRACE 
mode has a user HALT, a foreground breakpoint (76 HALT) and a 
dynamic SKIP key for user control during the TRACE. An implicit 
keypad is opened under several control points, with keys that 
variously service the display or assist local editing in RAM; also 
faster tape I/O is available. Super TLEGS (No. LL-0) will 



locate Super STEP for total address space access 
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1. 



LOADING: Load Super STEP under the SYSTEM command. First TBUG. 



SYSTEM 

•? TBUG Load TBUG. 

•t SPRSTP Load Super STEP. Volume 5H. 

#? / SMTKK Transfer control to 19^56. 

If s The S key links TBUG and 

Super STEP. 






Alternatively, 



SYST34 

•? TBUG 

*? / ENTER Transfer control to TBUG. 

# L Load SPRSTP using the TBUG 

# L command. 

# J UC00 Jump to cold start entry pt. 

# s Link with the S key. 



N. ' 



STEP 



(On versions relocated 



TL2GS 



relocated equivalent, then # S for final linking.) The I 3 key 
brings up the copyright header and the TBUG ¥ prompt character. 



2. 



AFTER 



3SF0R2 




RAM location and byte contents. 

Disassembled listing. Disassembler follows program flow order or 

straight line. 



m 



ropmost five stack elements. 



RAM enviroment selected by Intelligent 



RAM Window. Here in the 4- intelligent 

register to post the 



HL 




RAM window. 

mode, has selected curr 
ster indirect load. 



ent 



Flag expansion. Bit assignment header. 

3it expansion. 



Assembly mnemonic for testable bits. 




CPU registers. 



?C corresponds to the most recently executed instruction. 



3. 



FORMATTING THE DISPLAY: The display normally operates in 
a split screen mode; the left 1BR columns are scrolled and the 
right 25H columns are not scrolled (except during certain block 
RAM displays ). Both sides may be reformatted as follows: 



SCROLLING: As loaded, full left scrolling of memory locations and 

contents plus the disassembled listing. Alternatively, 
the user can select a reduced scrolling mode. (See use 
of the ■ key, belov. ) In this mode only tvo locations 
are scrolled, at the bottom of the left side of the 
screen. The scrolled areas are tvo lines 1BH characters 

■ 

long. The starting screen locations for these lines are 



STEP, in RAM 



may 



conflict with screen material displayed by a subject 
program. 



WORKSPACE: As loaded, the workspace displays tvo Z80 Processor 

Models, corresponding to prior and present CPU status 
relative to the instruction found at the PC of the 



labled Model. 



CPU 



relative to its PC. This arrangement unambiguously shovs 
the effects of each instruction. The unlabled, before 
Model may be suppressed. (See -* key, belov,) Also, 
both models may be suppressed. (See - key, belov.) 



RAM WINDOW: As loaded • the RAM 



the user may select any RAM area of interest for 
observation. (See +• key, belov.) 



h. 




Fig. 2. Implicit keypad under 3PRSTP 



CONTROL POINTS: There are five control access points- 
Control point 1: Open when TBUG I prompt character is displayed 

like # R, M, etc. 



Control point 2 



# M command, J 
byte RAM addre 



:er 



# M nnnn bb 



This is the access point shared by the mod- 
ify memory functions of TBUG. Most 3PRSTP . 
keys are accessible here, including SPACEBAR 
and : TRACE. 



Open under : TRACE mode to 
change, / SKIP, and Z-HALT 



speed 



Control point U: 



Open under (SHIFT) 
values, «-ieft and 
exit the mode keys. 



R to ac 
-aright 



pt hex-digit 
cursor, and X 



Control point 5: Opens under alternate *• RAM Vindov 

keystrokes to accept a two byte RAM 
or X exit the mode. The value ente 
the user RAM Windov enviroment. 



mode 
address 
d defines 



5. 






KEY FUNCTIONS: By row, from the bottom: 

SPACEBAR CT2 Single-steps current instruction. 

2 CP3 HALT key under : TRACE. 

(SHUT) < CP2 Delete byte, move string to FFFF one up. 
(SHIFT) > CP2 Insert byte, move string to FFFF one dovn. 
/ CP2 Suspends Z80 Model activity, makes dis- 
assembler straight -line. 
/ CP3 SKIP current instruction under : TRACE. 
( SHIFT) ? CP2 Display ASCII equivalent of current byte. 

t CT2 Displays relative location and byte contents. 
( SHIFT) t CP2 Relative Space memory advance. 

S CP1 Brings up copyright, links TBUG and SPRSTP. 
(SHIFT) L CP1 # L loads faster tapes made by (SHIFT) P. 

Display hex/ASCII 16 character line vith 
checksum, scroll workspace. 
(SHIFT) ♦ CT2 Alternates ; key between hex and ASCII. 
ENTER CP2 Advances memory display. (TBUG) 
CLEAR CP1 Clears current scrolling field. 
CLEAR CP2 Clears workspace area. 

♦ CP2 Backspace memory advance. 
(SHIFT) ♦ CP2 Return to Reference location. 
(SHIFT) R CP2 Change registers. Opens cursor over AF 

register. User may enter byte value or 
advance cursor with -* or ♦•• Exit with X. 




(SHIFT) P CP1 # P punches faster tapes 
9 CP2 00s the 280 Models. 





Changes RAM Window status. 
CPl* Cursor right under (SHIFT) R register change. 

Alternately suppresses /returns unlabled Model. 
CPU Cursor left under (SHIFT) R register change. 

1 CP3 Slow speed under : TRACE. 

2 CP3 High speed under : TRACE. 

(SHIFT) # 4T1 Loads SPRSTP Models with TBUG register contents. 

Same under Control point 2. 

TRACE until Z-HALT or encountering 76 HALT, 
(SHIFT) • CP2 CALL/RST status. Alternately single-step or 

directly execute CALLs and RSTs. 

Alternately suppresses Workspace display. 
(SHIFT) » CP1 Change scrolling mode from full to reduced ,back. 
BREAK CP1 Delink TBUG and SPRSTP. 






6. 



IMPLICIT KEYPAD: By control point and function. 
CONTROL POINT 1: Open when TBUG prompt character. comes up. 



I S Links TBUG and SPRSTP and brings up the copyright 

notice, which will scroll up and out. Initializes 
the scrolling field and SPACEBAR. 

BREAK Delinks TBUG and SPRSTP, used before relocating 

TBUG with Super TLEGS (No. LL-0) relocator. 

CLEAR Clears the scrolling field and reinitializes the 

prompt cnaracter position. 

(SHIFT) ■ Reformats the scrolling field. As loaded all 

rows scroll in a 1BE wide column. Pressing (SFT) * 
reduces the number of scrolling rows to two, located 
at the bottom left of the screen. The initial positions 
of the 1BH long scrolled lines are found in RAM 
locations 651CH and 651EH. The user may change these 
bytes to a desired screen position from 3C00H to 3FE4H, 
or suppress one by vectoring into unused RAM. This 
flexible reformatting is necessary because SPRSTP will 
sometimes be used to Single-step or : TRACE subject 
programs that conflict with background display. 

(SHIFT) Use of this key results in the loading of the ZoO 

Models displayed by SPRSTP with the contents of the 
R registers displayed by TBUG, and is related to a 
useful procedure as follows: Suppose you are examining 
some subject program and with to initialize SPRSTP 
relative to some point internal to the subject program. 
You might start at the entry point of the subject mat- 
erial and Single-step or : TRACE to the desired point. 
Another way involves using (SHIFT) 0. Place a TBUG 
breakpoint at the desired place in the subject program 
using B nnnn. The J Jump to the entrypoint and 
emerge via the breakpoint. At this point key (SHIFT) 
and F, then M nnnn, where nnnn is the (now restored) 
breakpoint location. SPRSTP is initialized relative to 
the subject program except for the stack; the S? is 
not transferred so the user may maintain an independent 
stack. Updating the SP involves finding the value with 
the R command and writing it into SPRSTP' s SP via 
the (SHIFT) R register change procedure. 

T. 



Control Point 1 continued: 



# (SHIFT) P This key is a faster P punch of cassette tapes 

obtained by adjusting timing loops. Tapes made 
under this command will not load under SYSTEM-, 
they art compatible only vith the SPRSTP command 
•# (SHIFT) L. 



(SHIFT) L This key is the L load command for tapes made 

by (SHIFT) P. Note that the normal ? and # 



GTxzman 



You should probably make a backup copy of SPRSTP, preferably at the 



higher baud rate. 



STEM 



tape maker. The most versatile is a version of TBUG relocated by 
Super TLEGS (NO. LL-0). Super TLEGS will also relocate SPRSTP. 
Here ve assume you have a version of TBUG at 7380-7980H. Control 
is vith a 1*380-1*980 TBUG linked vith SPRSTP, 



(SHIFT) P UB00 68FF UC00 # Punch vith fast loops, then BREAK 

# J 73A0 J Jump to the high TBUG. 

# P 1*380 U980 U3A0 # Punch a SYSTEM loading copy of 

the lov TBUG, This TBUG vill still 
have the fast timing loops from 
recording SPRSTP. 



make sure the lov conv of TBUG 



on the tape.) To load the melange, load the lov copy of TBUG (vhich 
happens to have the fast timing loops) under SYSTEM, then enter TBUG 
and key (SHIFT) L to load SPRSTP. It ' s an odd fact that fast loading 
tapes can be more reliable in that the chance of tape dropout is 
lessened vhen less tape is used. 



8. 



Control point 2: This access point is opened under the TBUG M 
command, after user entry of a tvo byte RAM address. TBUG then 
displays the contents "byte at that address and accepts any of 
ESTER i a user entered byte value or X, exiting the M mode. 



This is the most powerful 



RAM 



ined and modified. Both the Single-step and the : TRACE modes 
are available here, giving the user the ability to examine, mod- 
ify and execute instructions from the same control point. Why? 
So you car. write, debug and execute machine code with the fewest 
number of keystrokes. This feature can be very appealing after 
using multiple pass assemblers and other programming aids that 
operate with heavy keystroke overhead. Control point 2 is the 
closest you can get to your RAM and CPU if distance is defined 
as "number of keystrokes to get something done* 1 . 



SPACEBAR Use of this key under the TBUG M command will 

advance the TBUG displayed memory location and contents 
like BITER , but with the desirable addition of a dis- 
assembled mnemonic form of the instruction appearing 
in the scrolled field, and, after the trailing byte of 
the instruction has been SPACEd, the corresponding 
action in the Z80 Processor Model. This greatly 
decreases the imaginative overhead of the programmer, 

particularly in the extended, before/after Z80 Model 
format, where side-by-side comparison assures us of 

our results. Rote well that SPRSTP is a live program; 
all of these instructions are actually being executed. 
Since there are no write-protect constraints, use of 

this key can contaminate working RAM or result in 
fatal instruction executions. On the other hand, all 
you risk is having to reload. 

: TRACE This key initiates automatic single-stepping, starting 

at the displayed instruction and proceeding, in program 

9. 



HALT strin* delimi 



HALT is the foreground breakpoint, and U3e of the T3UG CD 9tfU3 
# B placed breakpoint will only lead : TRACE flow into T3UG. 
(Although SPRSTP vill run TBUG perfectly veil; try it vita an 
independent, Super TLEGS relocated copy. It helps to use the 
restricted scrolling mode. Line up over the entry point: 

M T3A0 ED : TRACE 

Exit the : TRACE by using 2-HALT. Note that the conflict 
between the SPRSTP and the subject T3UG scrolling fields can 
be resolved by formatting SPRSTP to say, 3F90 and 3FD0H. Recall 
this is done by changing location 651C and 6512H. ) A further 
control access point i3 opened under : TRACE, with these keys: 

1 Slow speed : TRACE, posts "IST* on status panel. 

2 Fast speed : TRACE, posts "25D" . 

/ SKIP key causes next instruction to be disregarded 

by execution flow, typically used to fall out of 
loops during : TRACE. SKIPped instruction is 
disassembled aormally. 

2 Z-HALT provides keyboard HALT control during : TRACE. 

Maximum : TRACE speed is obtained under the following conditions; 
Reduced scrolling format and suppressed Z80 Models while (SHIFT) * 
CALL/RST status is set for direct execution. 

/ This key stops execution of instructions during the 

Single-step or : TRACE modes. A V" is posted on the 
status panel. The disassembler becomes straight-line. 
SPACEBAR and : TRACE now operate Jest: the scrolled- field, 
useful when only disassembly is needed. To reactivate 
the models press / again. 



IHT7T 



Change SPRSTP registers, turns on a cursor over th 
A register. Entering a byte value vill advance th 



e 

_ . - .e 

cursor. The cursor may be advanced left or rignt 

by uae of the ^- or -* keys, respectively. This action 
is wraparound; PC is next to AT*. Exit ( the mode 
by pressing the X key to return to control ooint 2. 
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This key alters the status of the RAM Window area. 
As loaded, the RAM Window automatically changes-.. 

under certain instructions to show RAM interaction 
with the CPU. All instructions that refer to RAM 
in any way will activate the window during Single- 
stepping with SPACEBAR or during : TRACE. The 
alternate display status of the RAM Window is as a 
window into a user-designated area. Pressing ♦• 
will open a control point over the top of the 
window structure; the user is expected to enter a 
two byte memory location or to exit via X to control 
point 2. The location posted in this way will presist 
through Single-stepping or TRACE to show a continuously 
updated picture of the designated RAM environment. As 
loaded this location is set to 5126H, the "execution 
block" area internal to SPRSTP. The next time you press 
the RAM Window will be returned to the automatic mode 




During this intelligent mode the user's screen will 
contain a simultaneous before /after picture of the 
RAM as referenced by the PC, the status of the CPU 
architecture and the RAM interacting with CPU. This 
is the TRS-30 of the programmer's imagination. 



Formatting the Workspace: Under control point 2 f we have... 

Suppress the unlabled Z80 Model. The next time you 
press -* the model will return. The model is re- 
initialized when it returns; it does not retain any 
usuable "before" state information. 

Suppress both 230 Models. In this case both before 
and after state information can be recovered because 
the Processor Models are still active (subject to 
and /), they Just aren't shown. 

CLEAR Clears the workspace area. CLEAR under control point 1 

will clear the scrolling field. 
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(SHIFT) * This key controls whether CALLs and RSTs are 

to be single-stepped or directly executed. As 
loaded these instructions will be 3 ingle-stepped, 
when (SHIFT) • is pressed a "•" will light ia 
the status panel and CALLa and RSTs will be 
directly executed. Note that a subroutine must 
return to the CALLing routine for SPRSTP to keep 
control. If this is aot the case control may 
be transferred to the subject program. The next 
time (SHIFT) • is pressed the "*" will go out 
and CALLs and RSTs will be single-stepped, etc. 

(SHIFT) # Works like in control point 1; SPRSTP registers 

are loaded with TBUG registers. Control is 

returned to control point 2. 

% 00s the SPRSTP registers AF*-IY. SP is retained. 

The following keys assist local writing and editing of 230 machine 
language strings and programs in RAM. 

♦ Backspace. Advances the memory display to the 

predecessor location. 

* Relative Locator. Displays address and contents of 

the location relative, in a twos complement 
sense, to the current location. If the current 
memory contents byte were the offset byte of a 
relative Jump JR or DJNZ instruction the |> 
Relative Locator key shows where the transfer 
would go. 

(SHIFT) ♦ Relative Space. Advances memory display to the 

actual relative location. Also stores the 
current location for reference by... 

(SHIFT) f Reference Space. Advances memory display to 

the location stored by (SHIFT) 4 Relative Space. 
Used to return from working on a relative routine, 
or to return to a reference location established 
by the sequence (SHIFT) ♦, (SHIFT) *> such as 

the tOD of the code stria* vou are writin«. etc. 
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The following keys display and reformat RAM locations and contents. 

(SHIFT) ? Displays the ASCII or graphics character 

associated with the current contents byte. 



; Line display of the 10H bytes starting with 

the current memory location. Displays the 
checksum of the row as «bb-. Advances 
memory to location 10H hence. The line can 
be displayed in either hex or ASCII, set by... 

(SHIFT) ♦ Set hex/ASCII line. As loade d th e line will 

be displayed in hex; after (SHIFT) ♦ the line 
will be displayed in ASCII equivalents until the 
next time (SHIFT) ♦ is pressed, when the line 
displayras hex, etc. etc. 

(SHIFT) < Delete current byte, pull successor string one 

location toward current location. Successor 
string is defined down to the user-placed F FFF * 

string delimiter. Joy. aust P iace **** F ' FTF 
delimiter. Don't use these keys until you 
place FFFF at the foot of the string you are 
working with. Illustrated: 

I M 7000 00-09- 00 01 02 03 FF FF 06 0T FF FF FF FF FF FF FF FF 

# M 7000 00 (SHIFT) Delete. 

# M 7000 01-08- 01 02 03 FF FF FF 06 07 FF FF FF FF FF FF FF FF 

The code string has moved toward the current 
location by one, leaving an FF into the foot 
of the string. 

(SHIFT) > Insert a byte, pushes 3tring from current 

location to FFFF string delimiter one move 
away from the current location, rotates the 
byte wiped out by the leading FF into the 
current location for i'spection. Illustrated: 

* M 7000 01 (SHIFT) Insert. 

* M 7000 FF-08- FF 01 02 03 FF FF 06 07 FF FF FF FF FF FF FF FF 

I M 7000 FF (SHIFT) Insert. 

§ M 7000 06-08- 06 FF 01 02 03 FF FF 07 FF FF FF FT FF FF FF FF 

13. 



MISCELLANEOUS; 



If you wish to experiment vith the RST instructions, the high byte of 
the RST "page zero" is located within SPRSTP at location. 5EC0H. As 
loaded this byte is initially 00. Ineert your own high byte if you 
wish a programmable page zero. Of course the RSTs will only vector 



TRACE 



CALL /RST 



As to why anyone would be 



interested in the RSTs, see my short article M Z80 User Stack 
Emulation" in BYTE magazine, January, 1980. 



In the automatic mode the RAM Window will operate upon instructions 
such as indirect loads and stores y indirect I/O operations, indirec 
arithmetic and logical instructions, all indirect indexed instruct- 



ions, successful JPs, JRs, CALLS , DJKZ and all block ins 
Here is a procedure using CPIR as a memory search functi 



Set up the A register with some desired byte and HL with the 
address where you want the search to start. Use the [SHIFT ) R 
register change key for this. Maka sure RAH Window is on 4— mode 

# M 7000 ED CPIR SPACEBAR 

7001 Bl SPACEBAR Rote the RAM Window. 

7M2 FT ♦ Backspace 

7001 Bl ♦ Backspace 

7000 ED CPIR SPACEBAR etc. etc. 

Obviously the block comparisons and block loads can be used 

flexibly to compose the usual monitor MOVE and SEARCH functions. 



TRACE mode and the foreground 76-KALT 



breakpoint. 



1U. 



I 7000 CD CALL U5E9 TBUG routine puta keyboard byte in A. 

7001 E9 

7002 1*5 

7003 FE CP 0D Is it ENTER? 
7001 0D 

7005 20 JR 7000 If not, check a$ain. 

7006 F9 

7007 76 If bo, HALT the TRACE. 

Set up this code and use TRACE starting at 7000. You can vary speed 
using 1 and 2 or HALT using Z or in this case, ENTER. 



DANGEROUS BENDS: 



HALT foreground breakpoint before # J Jumping 



to the routine. 



Using ( SHIFT )< Delete and (SHUT)) Insert without placing the TTTT 

string delimiter at the foot of the code string. 

Loads of any kind into working RAM, especially block loads with 

large values in BC. 

Subroutines that never return under (SHIFT) # execution. 

Programs that test RAM by successively altering bytes, such as 

ROM and EDTASM. By the pigeon-hole principle working RAM in 

SPRSTP will be altered if you TRACE a program like this without 



I/C instructions can enable flip-flops inopportunely. 



BREAK key. See below. STELEG 



Don't let any of the above deter you from experimentation though, 
because often system crashes are educational. Also, the single key 
commands used on SPRSTP may take a little getting used to, since 
they are necessarily a little arbitrary, but it is the fastest and 
easiest command mode when familiar. So become a Super STEP adept! 



15. 



STELEGS RELOCATOR: The top 300H bytes of SPRSTP art uncondensable 
relocator table* compatible with. Super TLB3S (No. LL-O) Relocator 
for TBUG. Relocation procedures will be familiar to Super TLECS 
users. In the following example we assume a linked TBUG-TLEGS- 
SPRSTP unit at U380-^980, 1*9A0-UAA0, and UB00-6.8FF. 



TBUG start addre 



First relocate TBUG. We will be using 32K resources here. 

t BREAK Delink TBUG and SPRSTP 

# M 14831 80 Load DE with desired TBUG start address 
U832 83 

U833 30 Load HI with present 

U83U U3 

# R Check the TBUG registers. 

# J U9A0 # J Jump to Super TLEGS. Control is now 

with the high TBUG. 

We are ready to relocate SPRSTP. The entry point will be at 
UCA0H. First we load DE and 3L. 

CONSTRAINT: DE must have 1E00H bytes vertical clearance. 

S must be 00. 

# M 3831 00 Load DE with desired SPRSTP start address. 
8832 8B 

3833 00 Load HL with present 
383U UB 

8835 80 DC loaded with desir 

8836 83 

8837 80 IY loaded with present linking TBUG start. 
3838 U3 

# R Check TBUG registers. 
I J 1*CA0 I J Jump to STELZGS. 

# S Press S to link. * is high copy prompt character. 

To recap, STELZG needs the following parameters passed to it via th 
TBUG registers: DE contains desired SPRSTP starting address, with 
byte 00, HL contains present SPRSTP starting address. 

DC contains the starting address of the copy of T3 
with which the new SPRSTP must link, and 

IY contains the starting address of the present co 
of TBUG with which the present copy of SPRSTP is linked. Only when 
this material is entered can a successful J UCA0 be made. 

16, 



SPRSTP start 



TBUG start 



ALL 
Sox 
San 



N GELDER SOFTWARE 

11721 Main Post Office 
Francisco, CA 9^101 



